home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / src / X11 / wais / doc / waistation_users_guide.txt < prev    next >
Text File  |  1995-05-09  |  18KB  |  434 lines

  1. This is the User's Guide to the Macintosh version of the WAIS interface.
  2. It is provided here as a reference guide to the other WAIS user interfaces
  3. provided with this release.
  4.  
  5. ------------------------------------------------------------------------
  6.  
  7. WAIStation
  8.  
  9. This program is distributed free of charge by Thinking Machines
  10. Corporation.  Permission is hereby granted to anyone to use, duplicate,
  11. modify and redistribute this program for internal use, so long as this
  12. notice is attached.
  13.  
  14. Thinking Machines Corporation provides absolutely no warranty of any kind
  15. with respect to this program.  The entire risk as to the quality and
  16. performance of this program is with the user.
  17.  
  18. IN NO EVENT WILL THINKING MACHINES CORPORATION BE LIABLE TO ANYONE FOR ANY
  19. DAMAGES ARISING OUT OF THE USE OF THIS PROGRAM, INCLUDING WITHOUT
  20. LIMITATION DAMAGES RESULTING FORM LOST DATA OR LOST PROFITS, OR ANY
  21. SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES.
  22.  
  23.  
  24. WAIStation
  25.  
  26. A User Interface for 
  27. Wide Area Information Servers
  28.  
  29. User Guide, Prototype Version
  30.  
  31. This document briefly describes the initial prototype of WAIStation, a user 
  32. interface for Macintosh developed by Thinking Machines Corporation. 
  33. WAIStation enables users to retrieve information from the DowQuest document 
  34. retrieval system at Dow Jones News/Retrieval, the Connection Machine 
  35. Document Retrieval System, your local Macintosh, and any other database server 
  36. that supports the WAIS protocol. 
  37.  
  38. The interface communicates with the database server using an ANSI standard 
  39. protocol for database retrieval applications, called Z39.50 (see references). 
  40. WAIStation communicates through either the serial port (to a modem or terminal 
  41. line) or via AppleTalk or EtherNet to a UNIX system running the Connection 
  42. Machine Document Retrieval System. 
  43.  
  44. The goal of the Wide Area Information Servers project is create an open
  45. architecture of information servers and clients by deriving and standardizing a
  46. computer-to-computer protocol that will enable users to find and question
  47. servers.
  48.  
  49. For more information on the WAIS project see the references section at the end 
  50. of this document.
  51.  
  52.  
  53. The information in this document is subject to change without notice and should
  54. not be construed as a commitment by Thinking Machines Corporation.  Thinking
  55. Machines Corporation reserves the right to make changes to any products
  56. described herein to improve functioning or design.  Although the information in
  57. this document has been reviewed and is believed to be reliable, Thinking
  58. Machines Corporation does not assume responsibility or liability for any errors
  59. that may appear in this document. Thinking Machines Corporation does not assume
  60. any liability arising from the application of use of any information or product
  61. described herein.  Connection Machine is a registered trademark of Thinking
  62. Machines Corporation. WAIStation is a trademark of Thinking Machines
  63. Corporation.
  64.  
  65. UNIX is a trademark of AT&T Bell Laboratories.
  66.  
  67. Apple, AppleTalk and Macintosh are registered trademarks of Apple Computer,
  68. Inc.
  69.  
  70. Dow Jones News/Retrieval is a registered service mark of Dow Jones & Company,
  71. Inc. DowQuest is a trademark of Dow Jones & Company, Inc.
  72.  
  73. Thanks to Advanced Software Concepts for TCPack software.
  74.  
  75.  
  76. Copyright 1990, 1991 Thinking Machines Corporation. All rights reserved.
  77.  
  78. Thinking Machines Corporation
  79. 245 First Street
  80. Cambridge, Massachusetts 02142-1214
  81. (617) 876-1111
  82.  
  83. WELCOME TO WAIStation 
  84.  
  85. Have you ever been frustrated by a search-and-retrieval system that couldn't
  86. seem to understand what you wanted?
  87.  
  88. Have you ever looked through a dozen retrieved articles to find only one that
  89. met your intent?
  90.  
  91. Have you ever wanted to wave that one good article at the system, and say Look!
  92. This is what I want! Find me more articles like this one!
  93.  
  94. Well, now you can do exactly that. 
  95.  
  96. WAIStation was built around two notions: first, that the user of a search-and-
  97. retrieval system should be able to provide feedback to assist or retarget the
  98. search; and, second, that the best way to search for articles (or any other
  99. documents) is to search from a good example, not just from one or two keywords.
  100.  
  101. So, the model for a WAIStation search is: 
  102. *    Start with a few key words or phrases (as usual). 
  103. *    Examine the articles WAIStation retrieves. 
  104. *    Tell WAIStation which articles, or which sections of articles, you find
  105. most useful (i.e. closest to the subject you're looking up). Ask it to search
  106. again, using those selections as models.
  107. *    Repeat the process until you've found what you want. 
  108.  
  109. SHARPENING AND WIDENING SEARCHES
  110.  
  111. Providing relevance feedback to WAIStation, as explained above, lets you zero
  112. in on precisely the information you're looking for. But it also lets you widen
  113. a search, or change it completely. While you're hunting for information on
  114. Subject A, if an interesting article on Subject B turns up you can select that
  115. article as the model for the next search. What's more, you can branch off onto
  116. a new search without losing track of your original search. In fact, you can
  117. continue both searches, and even start others; the range and movement of your
  118. searches are up to you.
  119.  
  120. SEARCHING IN MANY SOURCES
  121.  
  122. WAIStation gives you access to sources of information ranging from files stored
  123. on your own computer's disks to electronic libraries across the country.
  124. Moreover, it lets you search through any combination of these sources in a
  125. single, integrated search. You choose which sources are to be used for which
  126. searches; you can change your mind at any stage during the search.
  127.  
  128. AUTOMATICALLY RE-SEARCHING QUESTIONS
  129.  
  130. Since new information arrives all the time, you frequently want to run searches
  131. at intervals, to find out what's new in some particular area. To facilitate
  132. this, WAIStation lets you store the data from a search as a Question. You can
  133. then instruct WAIStation to run questions for you at selected intervals. For
  134. example, WAIStation can run questions for you each morning at 3 am, and have
  135. the results waiting for you when you come into work. (Of course, you can re-run
  136. your questions interactively, or change them as you like, at any time.)
  137.  
  138. GO AHEAD  EXPLORE!
  139.  
  140. This introduction has only suggested what WAIStation can do for you. The rest
  141. of this Quick Reference Guide will explain how to do each of the items
  142. mentioned above. But to get fullest use out of WAIStation, you'll have to try
  143. it out for yourself. Explore experiment see what works best for you. And
  144. please, since this is still an experimental system, let us know how you like
  145. it. Fill out and mail the questionaire at the end of this booklet. Or,
  146.  
  147. Send comments, questions, complaints, or praise to:
  148. Brewster Kahle
  149. Thinking Machines Corporation
  150. 245 First Street
  151. Cambridge, MA 02142
  152. (617) 234-1000
  153. Email: wais@think.com
  154. AppleLink: wais@think.com@dasnet#
  155.  
  156. TABLE OF CONTENTS
  157.  
  158. Getting Started                    2
  159. Creating a New Question                3
  160. Getting Results                    4
  161. Search Strategies:  Improving Questions        5
  162. Selecting Part of a Document            6
  163. Other Methods                    7
  164. Search Strategies  Following Tangents        8
  165. Chaining Questions                9
  166. To Close and/or Save a Question            10
  167. To Save a Question Without Closing It        10
  168. To Re-Open a Question                10
  169. Keeping Up-To-Date on Sources            11
  170. References                    12
  171. Questionaire                    13
  172.  
  173. GETTING STARTED
  174.  
  175. Double-click on the WAIStation icon:
  176.         
  177. The SOURCES and QUESTIONS windows will appear.
  178.                               
  179. Sources are generally available to everyone at a given site.  Questions, on the
  180. other hand, generally belong to individuals. If this is the first time you have
  181. used WAIStation, your QUESTIONS window will probably be empty.  When you save a
  182. question, its name and icon appear in your window.
  183.  
  184. CREATING A NEW QUESTION
  185.  
  186. 1.    From the QUESTION menu, select NEW QUESTION.
  187.                     
  188. A new QUESTION window opens. 
  189.  
  190. 2.    Choose a source that you want your Question to search. Drag it from the
  191. SOURCES window into the From These Sources field in the QUESTION window.
  192.                                                               
  193.  
  194. The source name will appear in the sources field.
  195.  
  196.     Do this for as many sources as you wish.
  197.  
  198. 3.     Type words or phrases in the Look for documents about field, describing
  199. the subjects about which you want information. WAIStation searches for these
  200. words to find useful documents.
  201.  
  202. 4.     Click on RUN, to run the question. (See GETTING RESULTS, on page 4)
  203.  
  204. GETTING RESULTS
  205.  
  206. 1.     Click on RUN (or, hit RETURN).
  207.  
  208. The world cursor will turn while WAIStation searches for documents that 
  209. match your request. The Results field then displays the titles of the most 
  210. useful documents found. Documents are ranked from 0 to 3 stars, depending 
  211. on how well they match the question: the best matches are at the top of the 
  212. list. 
  213.  
  214. Click on the scroll bar to see more documents.
  215.                                                
  216. 2.    Double-click on any document in the list to display it.
  217.                                                             
  218. A new window opens, displaying the document. If the document is too large 
  219. to fit in the window, the section that shows the best match to your question 
  220. is displayed.
  221.  
  222.     You can display as many of the documents as you like. You can also save
  223. and print documents, using commands in the FILE menu. The TEXT menu contains
  224. commands that control the format in which documents are displayed.
  225.  
  226. 3.     Searching from keywords alone is rarely sufficient. At this point,
  227. therefore, you probably want to to select some documents (or some sections of
  228. some documents) to guide the next step of your search. The next few pages
  229. explain how to do this and suggest some possible search strategies.
  230.  
  231.     On the other hand, you may have found what you wanted; or, you may not
  232. have time at the moment to pursue the search. In these cases, you can either
  233. discard your question or save it to re-use at a later time. For information on
  234. how to do this, see page 10.
  235.  
  236. SEARCH STRATEGIES:  IMPROVING QUESTIONS
  237.  
  238. You can use the information from one set of results to modify your original
  239. question or to create further questions. Improving your original question often
  240. leads to improved results. So, if your first search didn't provide what you
  241. want, try one of the following techniques.
  242.  
  243. 1.     Probably the best way to improve a question is to drag one or more 
  244. particularly interesting documents from the Results list into the Similar 
  245. To field. This allows WAIStation to get a fuller sense of what you're looking 
  246. for, and thus a better chance of finding the information you need.
  247.                                                
  248. When you run the question again the Results list will be updated with the 
  249. new results, which will include documents similar to the one you selected (if 
  250. such documents exist in the database). 
  251.  
  252. SELECTING PART OF A DOCUMENT
  253.  
  254. 2.     Alternatively, if one particular section within a document seems more
  255. useful than the rest, you can ask WAIStation to search for documents that
  256. resemble that section. To do that,
  257.  
  258. *    Drag the cursor over a section of the document to select the text.
  259.                                                        
  260. An icon will appear in the left margin.
  261. *    Drag the new icon into the Similar To field.
  262.                                                       
  263.     Run the query again.
  264.  The results will be updated with documents similar to the text you 
  265. selected.
  266.  
  267. OTHER METHODS
  268.  
  269. 3.     You can add or remove searchwords. This is often helpful if WAIStation
  270. didn't interpret your initial words the way you expected it to.
  271.  
  272.     Add searchwords by typing them in; remove them by backspacing over them, 
  273. or by selecting them with the mouse and then pressing Delete.
  274.  
  275. 4.     You can add or remove sources.
  276.     Add sources by dragging them into the source field; remove them by
  277. dragging them out of the source field.
  278.  
  279.     After modifying your QUESTION, click again on RUN.  A new list of
  280. documents will be displayed. (If the new list is identical to the old list,
  281. then you may want to try using different searchwords.  Otherwise, chances are
  282. that you need to try a different approach, or that the database really
  283. doesn't contain any more documents that are relevant to your question.)
  284.  
  285. SEARCH STRATEGIES  FOLLOWING TANGENTS
  286.  
  287. The techniques listed on the previous page explained how to improve a search
  288. for information on your original topic. Other search strategies involve
  289. changing topics, perhaps to follow up some new line of questioning that grew
  290. out of your original search.
  291.  
  292. *    You can change the topic completely by changing searchwords.
  293. *    You can follow a new line of research that suggests itself, by dragging
  294. the relevant result(s) whole documents or sections into the Similar To field.
  295.  
  296. You may want to change your searchwords to fit the new topic, as well.
  297.  
  298. Either of these strategies can be accomplished either by altering your original
  299. question, or by creating new questions that preserve the context of the older
  300. questions. Chaining questions in this manner allows you to follow interesting
  301. new directions in a search, without losing any of your old data.
  302.  
  303. CHAINING QUESTIONS
  304.  
  305. 1.     While one question window is open, select NEW QUESTION from the
  306. QUESTION menu.
  307.  
  308. The new Question window will contain the same sources as the existing 
  309. Question window has. You can alter this list of sources, or use it as is.
  310.  
  311. 2.     Drag documents or sections of documents from the existing Results into
  312. the Similar To field in the new Question window. Or, type searchwords into the
  313. new window. Or do both.
  314.                                                        
  315. 3.     RUN the new question.
  316.  
  317.     You can continue to chain questions at will. You can save any of these 
  318. questions whenever you like.
  319.  
  320. TO CLOSE AND/OR SAVE A QUESTION
  321.  
  322. 1.     Click on the box in its upper left corner.
  323.  
  324. If the question has not been saved previously, or if you have made changes 
  325. to the question, WAIStation asks you if you want to save the changes you 
  326. have made.
  327.  
  328. 2.    Click on YES to save the new version of the question.  If the question
  329. has not been saved before, it will appear in the QUESTIONS window.
  330.  
  331.     Click on NO to discard the modifications (or, if this is a new
  332. question, to discard the entire question.)
  333.  
  334. TO SAVE A QUESTION WITHOUT CLOSING IT
  335.  
  336.     Select SAVE or SAVE AS from the FILE menu.
  337.  
  338. TO RE-OPEN A QUESTION 
  339.  
  340.     Double-click on its icon in the QUESTIONS window. (Or, open the
  341. question from the QUESTION menu.)
  342.  
  343. KEEPING UP-TO-DATE ON SOURCES
  344.  
  345. Your System Administrator will have arranged to have some or all of your site's
  346. sources updated at regular intervals. Needless to say, these intervals may not
  347. be the same for all sources. (A daily newspaper and a weekly magazine will
  348. probably be updated at different intervals.)  In order to decide when you want
  349. your Questions run, therefore, you must ask two questions: How often am I
  350. interested in checking this question? and How often (and when) will its sources
  351. be updated? If your sources are updated daily, it makes no sense to re-run your
  352. questions every hour; if you only want to check for new data once a week, then
  353. running the question weekly is the best strategy.  To find out when a source is
  354. updated, and to tell WAIStation when to search that source for you, use the
  355. SOURCE window for each source your questions search.
  356.  
  357. 1.     Double-click on a Sources icon (or choose OPEN SOURCE from the Source 
  358. menu).
  359.                                                              
  360. The SOURCE window for the selected source appears. You will notice, in the 
  361. upper half of the window, information that tells you when the database for 
  362. this source is updated.
  363.  
  364. 2.     You may select the number of document headlines you wish to have
  365. displayed with the Number of Documents pop-up menu.
  366.  
  367. 3.    You can also select the default font and size of the text for documents
  368. that are displayed from this source, using the Font and Size pop-up menus.
  369.  
  370. 4.     Click on the Contact field in the lower half of the window. Choose how
  371. often you want your questions to search this source.  The selected interval
  372. will appear in the Contact field, followed by fields that request further
  373. information.
  374.  
  375.     Click on those fields, and enter the information. See your system
  376. administrator for additional assistance.  Note: Try to select a time for your
  377. automatic searches that won't conflict with the times everyone else chooses. A
  378. couple of good guidelines are: Don't search a source as soon as it's updated;
  379. and, if you're specifying an exact time, use an odd number of minutes: 3:52,
  380. for example, rather than 3:30 or 4:00.  Note also: every question of yours that
  381. searches this source gets updated at the time you choose. Questions that search
  382. multiple sources get updated every time one of their sources is searched.
  383.  
  384. REFERENCES
  385.  
  386. Wide Area Information Concepts, Brewster Kahle.  Thinking Machines Technical 
  387. Memo DR-89-1.  Available from Thinking Machines Corporation or Brewster Kahle 
  388. (Internet: brewster@think.com; AppleLink: BREWSTER).
  389.  
  390. WAIS Interface Protocol Prototype Functional Specification, Franklin Davis et
  391. al. Thinking Machines. Available from Franklin Davis (Internet: fad@think.com;
  392. AppleLink: FAD) or Brewster Kahle (brewster@think.com, BREWSTER).  Z39.50-1988:
  393. Information Retrieval Service Definition and Protocol Specification for Library
  394. Applications.  National Information Standards Organization (Z39), P.O. Box
  395. 1056, Bethesda, MD 20817.  (301) 975-2814.  Available from Document Center,
  396. Belmont, CA. Telephone 415-591-7600.  DowQuest promotional literature available
  397. from Dow Jones & Co. Inc., 200 Liberty Street, New York, NY 10281.
  398.  
  399. QUESTIONAIRE
  400.  
  401. As part of the WAIS research project, your feedback is extremely important. 
  402. Please take a few minutes to complete this after you have become comfortable 
  403. with WAIStation.
  404.  
  405. 1.    How could WAIStation be better?
  406.  
  407. 2.    What was confusing about WAIStation?
  408.  
  409. 3.    What could be removed from WAIStation?
  410.  
  411. 4.    What could be added?  What could WAIStation do for you?
  412.  
  413. 5.    Did you make any discoveries about WAIStation?
  414.  
  415. 6.    How much time did you use WAIStation?
  416.  
  417. 7.    Did WAIStation feel like a real Macintosh program?
  418.  
  419. 8.    If you have used other information retrieval programs, please comment
  420. on how WAIStation compared. Please list the systems you are comparing with.
  421.  
  422. 9.    Was the User Guide helpful? Do you have suggestions?
  423.  
  424. 10.    Other comments:
  425.  
  426.  
  427. Thank you! Please fold and mail this, or give it to your system administrator.
  428.  
  429. Brewster Kahle
  430. Thinking Machines Corporation
  431. 245 First Street
  432. Cambridge, MA  02142-1264
  433.  
  434.